W03-1. 포트 · 볼륨 · 네트워크 - 강의 노트

3주차 강의 노트: 포트 · 볼륨 · 네트워크

이번 주 목표

  1. 포트 공개(-p) 의 원리와 127.0.0.1 바인딩의 의미를 안다.
  2. 데이터를 컨테이너 밖에 두는 두 방법, 바인드 마운트와 볼륨의 차이를 안다.
  3. 컨테이너끼리 이름으로 통신하려면 사용자 정의 네트워크가 필요하다는 것을 안다.

진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)

지난주 복습

  • 생명주기: Created → Running ⇄ Paused → Exited → 삭제
  • 메인 프로세스가 끝나면 컨테이너도 끝난다
  • 컨테이너를 지우면 안의 데이터도 사라진다 → 오늘 해결합니다


1. 컨테이너가 가진 세 가지 "벽"

컨테이너는 격리된 프로세스라서 기본적으로 바깥과 막혀 있습니다. 오늘은 그 벽에 필요한 만큼만 구멍을 내는 법을 배웁니다.

벽 기본 상태 오늘 배울 구멍
네트워크 (바깥 ↔ 컨테이너) 바깥에서 접속 불가 포트 공개 -p
저장소 (컨테이너 ↔ 디스크) 지우면 데이터 사라짐 바인드 마운트, 볼륨 -v
컨테이너 ↔ 컨테이너 서로 이름을 모름 사용자 정의 네트워크 --network

2. 포트 공개: -p 호스트포트:컨테이너포트

flowchart LR
    B["브라우저
localhost:8080"] --> H["내 노트북
8080 번 포트"] H -- "-p 8080:80" --> C["컨테이너
80 번 포트 (nginx)"]
쓰는 법 의미 누가 접속 가능?
-p 8080:80 모든 네트워크 카드의 8080 → 80 내 노트북 + 같은 네트워크의 다른 PC
-p 127.0.0.1:8080:80 내 노트북 안(localhost)에서만 8080 → 80 내 노트북만
-P (대문자) 이미지에 적힌 포트(EXPOSE)를 아무 빈 포트에 연결 포트 번호는 docker port 로 확인
보안 감각: DB 포트를 함부로 열지 마세요

-p 5432:5432 로 DB 를 띄우면 같은 와이파이의 다른 사람도 접속을 시도할 수 있습니다.
내 노트북에서만 쓸 거라면 -p 127.0.0.1:5432:5432 처럼 막아 둡니다. 실습에서 직접 차이를 확인합니다.
더 좋은 방법은 DB 포트를 아예 공개하지 않고, 같은 네트워크의 컨테이너끼리만 통신하게 하는 것입니다(4장).

이미지의 EXPOSE 는 "안내문"일 뿐

2주차 docker image history 에서 EXPOSE map[80/tcp:{}] 를 봤습니다. 이것은 "이 이미지는 80번을 씁니다" 라는 문서일 뿐이고, 실제로 열어 주는 것은 -p 입니다.


3. 데이터를 컨테이너 밖에: 바인드 마운트 vs 볼륨

컨테이너 안의 특정 폴더를 컨테이너 밖의 저장 공간과 연결하면, 컨테이너를 지워도 데이터가 남습니다.

flowchart TB
    subgraph L["내 노트북"]
        F["📁 ~/docker-study/site
(내가 아는 폴더)"] subgraph VM["Docker 가 관리하는 영역"] V["🗄️ 볼륨 study-pgdata
(Docker 가 아는 저장소)"] end end C1["nginx 컨테이너
/usr/share/nginx/html"] -- "바인드 마운트" --- F C2["PostgreSQL 컨테이너
/var/lib/postgresql"] -- "볼륨" --- V
구분 바인드 마운트 (Bind Mount) 볼륨 (Volume)
쓰는 법 -v /내/폴더/경로:/컨테이너/경로 -v 볼륨이름:/컨테이너/경로
저장 위치 내가 지정한 노트북 폴더 Docker 가 관리하는 영역
노트북에서 직접 보기·편집 쉬움 (VS Code 로 바로 편집) 어려움 (Docker 를 통해서만)
주 용도 개발 중인 소스 코드, 설정 파일 DB 데이터 등 앱이 쌓는 데이터
관리 명령 없음 (그냥 폴더) docker volume ls / inspect / rm
비유 내 책상 서랍을 빌려줌 회사 문서 보관소에 맡김
구분하는 법

-v 앞부분이 경로(/, C:\, ${PWD} 등으로 시작)면 바인드 마운트, 그냥 이름이면 볼륨입니다.

읽기 전용 :ro

-v ...:/usr/share/nginx/html:ro 처럼 끝에 :ro 를 붙이면 컨테이너는 그 폴더를 읽기만 할 수 있습니다. 웹 서버가 해킹당해도 원본 파일은 바꾸지 못하게 하는 안전장치입니다.

DB 이미지마다 "데이터 폴더" 가 정해져 있다

볼륨은 앱이 데이터를 쓰는 폴더에 연결해야 의미가 있습니다. 경로는 공식 이미지 설명서(Docker Hub)에 있습니다.

  • PostgreSQL 18 이상: /var/lib/postgresql ← 2025년에 바뀐 경로
  • PostgreSQL 17 이하: /var/lib/postgresql/data
  • MySQL: /var/lib/mysql

인터넷의 예전 자료를 18 버전에 그대로 쓰면 데이터가 남지 않을 수 있습니다.


4. 컨테이너끼리 통신: 사용자 정의 네트워크

웹 서버 컨테이너가 DB 컨테이너에 접속해야 한다면, 상대를 어떻게 찾을까요?

방법 문제
IP 주소로 (172.17.0.2) 컨테이너를 다시 만들 때마다 IP 가 바뀝니다
이름으로 (study-db) 기본 네트워크에서는 이름을 못 찾습니다 ❌
사용자 정의 네트워크에서는 됩니다 ✅
flowchart LR
    subgraph D["기본 네트워크 (bridge)"]
        A1["컨테이너 A"] -. "study-web ? ❌ bad address" .-> A2["study-web"]
    end
    subgraph N["사용자 정의 네트워크 (study-net)"]
        B1["컨테이너 B"] -- "study-web ✅ 이름으로 접속" --> B2["study-web"]
        DNS["Docker 내장 DNS"]
    end
이것이 5주차 Compose 와 6주차 Kubernetes 의 기초입니다

  • Compose 는 앱마다 네트워크를 자동으로 만들어 주고, 서비스 이름으로 통신하게 합니다.
  • Kubernetes 의 Service 도 "이름으로 찾아가기" 를 클러스터 전체에서 해 주는 것입니다.

네트워크 드라이버 (참고)

드라이버 설명
bridge 기본값. 노트북 안에 가상 스위치를 만들어 컨테이너를 연결
host 컨테이너가 호스트의 네트워크를 그대로 사용 (격리 없음)
none 네트워크 없음


5. 전체 그림: 오늘 실습의 최종 모습

flowchart LR
    U["브라우저"] -- "localhost:8080" --> W
    subgraph NET["사용자 정의 네트워크 study-net"]
        W["study-web (nginx)"]
        T["접속 테스트용 컨테이너"] -- "study-db:5432" --> DB["study-db (PostgreSQL)"]
        T -- "http://study-web" --> W
    end
    W --- F["📁 바인드 마운트: site 폴더"]
    DB --- V["🗄️ 볼륨: study-pgdata"]

핵심 요약

3주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① 포트      -p 8080:80            노트북 8080 → 컨테이너 80
            -p 127.0.0.1:8080:80  내 노트북에서만 접속 가능
            EXPOSE 는 안내문, 실제로 여는 건 -p
② 저장      바인드 마운트  -v ${PWD}/site:/경로[:ro]   내 폴더 연결 (코드·설정)
            볼륨          -v 이름:/경로              Docker 관리 (DB 데이터)
            컨테이너를 지워도 데이터는 남는다
③ 네트워크   기본 bridge: 이름으로 못 찾음
            docker network create → 같은 네트워크면 "이름 = 주소"
④ 습관      DB 포트는 공개하지 말고, 같은 네트워크 안에서만 접속

참고 자료

더 깊이 보고 싶다면 (볼트 내 정리 노트):

공식 문서:


네비게이션

이전 목록 다음
◀ 2주차 실습 목록으로 3주차 실습 ▶